/*
 * Copyright [2022] [https://www.xiaonuo.vip]
 *
 * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
 *
 * 1.请不要删除和修改根目录下的LICENSE文件。
 * 2.请不要删除和修改Snowy源码头部的版权声明。
 * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
 * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
 * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
 * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
 */
package vip.xiaonuo.biz.modular.devicereservation.service;

import vip.xiaonuo.biz.modular.devicereservation.entity.DeviceReservation;

import java.util.Date;

/**
 * 设备预约状态管理Service接口
 *
 * @author Blurryface
 * @date  2025/04/27 14:47
 **/
public interface DeviceReservationStatusService {

    /**
     * 设置预约结束时间并创建延时队列任务
     *
     * @param deviceReservation 设备预约信息
     */
    void setReservationEndTime(DeviceReservation deviceReservation);

    /**
     * 将预约ID添加到Redis延时队列
     *
     * @param reservationId 预约ID
     * @param execTime 执行时间（时间戳）
     */
    void addToDelayQueue(String reservationId, long execTime);

    /**
     * 根据预约日期和时间段计算结束时间
     *
     * @param reservationDate 预约日期
     * @param timeSlot 时间段
     * @return 结束时间
     */
    Date calculateEndTime(String reservationDate, String timeSlot);

    /**
     * 更新预约状态为已完成
     *
     * @param reservationId 预约ID
     */
    void updateReservationStatus(String reservationId);

    /**
     * 从延时队列中移除预约
     *
     * @param reservationId 预约ID
     */
    void removeFromDelayQueue(String reservationId);

    /**
     * 处理延时队列中的到期任务（定时任务）
     */
    void processDelayQueue();
}